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IREAD THIS DOCUMENT BEFORE ATTEMPTING TO USE THE OBJECT KIT. 
ITHIS DOCUMENT DESCRIBES RELEASE 1.0.0 OF THE DNCS/SNA BATCH 
{LOGICAL UNIT EMULATOR OBJECT INSTALLATION MEDIA, PART NUMBER 
i 2339081-1601 <DISK OR TAPE) OR 2S39081-1602 (DISKETTE). REFER 
!T0 THE RELEASE INFORMATION. PART NUMBER 2539080-9901, FOR 
{ADDITIONAL INFORMATION. 

{TEXAS INSTRUMENTS ASSUMES NO RESPONSIBILITY FOR MODIFICATIONS 
SMADE TO THIS OBJECT KIT. 
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Section 1 
Introduction 



1. 1 GENERAL INFORMATION 

This document describes the installation of the DNCS/SNA Batch 
Logical Unit (SBLU) Emulator object under DNOS. 

Make a backup copy of the released object before executing the 
installation procedures. For copy procedures* refer to the DNOS 
Operations Guide , part number 2270302-9701. 

Consult the DNOS DNCS/SNA Batch Release Information , release 
1.0.0, part number 2339080-9901, for additional information 
concerning the current release. 

This installation document presents many System Command 
Interpreter (SCI) commands in batch format. You can execute 
these commands either by entering the entire command as shown or 
by entering only the command keyword and responding to the 
interactive prompts from SCI. For a discussion of the batch 
command format, refer to the DNOS Sustem Command Int erpreter 
(SCI) Reference Manual , part number 2270303-9701. 



1. 2 MEDIA DEFINITION 

Product shipments are made in the following formats: 

* Disk — A DS10, DS30, DS80, DS200, DS300, or CD1400 disk 
containing the object 

* Diskette — A double-sided, double-density (DSDD) 
diskette containing the object 

* Magnetic Tape — A cartridge tape or an 800 or 1600 bit- 
per-inch (bpi) magnetic tape containing the object 

* Add -On — A disk containing the object and one or more 
other products 
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1. 3 INSTALLATION OVERVIEW 

The installation process described in this document provides the 
steps required to prepare the DNCS/SNA Batch Emulator object for 
installation. 



1.4 SYSTEM REQUIREMENTS 

To perform these installation procedures successfully' you must 
have a DNOS operating system (Release 1.2.1 or later) running on 
a Business System 300, 600. or 800 computer with at least 512K 
bytes of memory. 

In addition! you must have completed DNCS system generation* with 
SBLU emulator support specified* and object installation for DNCS 
(Release 1.3.0 or later) on your system. Consult the DNOS 
DNCS/SNA Batch User's Guide , release 1.0.0, part number 2239996- 
9701, for information concerning definition of SBLU emulator 
support during DNCS system generation. Consult the DNOS DNCS 
Sustem Generation Reference Manual , release 1.3.0, part number 
2302648-970 1*B, for information concerning DNCS 1. 3. system 
generation. Consult the DNOS DNCS Nucleus Ob lect Installation, 
release 1.3.0, part number 2302660-970 1*C, for information 
concerning DNCS 1.3.0 installation. 
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Preparing for Installation 



Section 2 
Preparing for Installation 



2. 1 GENERAL 

The DNCS/SNA Batch Emulator object is shipped on various media 
and must be prepared prior to installation. The media must be 
restored to disk (if supplied on magnetic tape), copied to disk 
(if supplied on diskette)* or used directly (if supplied on 
disk). This section describes how to prepare each type of media. 



The procedures 
require that 
<dncsvolume> be 
Section 2 of 
Installation . 



NOTE 

outlined in 

the DNCS 
installed as 
the DNOS DNCS 



this section 

parts volume 

described in 

Nucleus Ob lect 



2. 2 DOUBLE-SIDED. DOUBLE-DENSITY (DSDD) DISKETTE FORMAT 

When you receive the object on DSDD diskette. perform the 
following steps: 

1. Enable the write protection for the DNCS/SNA Batch 
Emulator object diskette DCBLU by carefully removing 
the silver sticker from the diskette. 

2. Load the DCBLU diskette into an available drive and 
make it ready. 

3. Install the diskette volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V-DCBLU 

where: 

<dsxx> is the name of the drive where the diskette is 
loaded. 
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4. Copy the contents of diskette DCBLU to the DNCS parts 
volume by using the Copy Directory (CD) command as 
follows: 

CD I=DCBLU» 0=<dncsvolume>. DCBLU. L=. LISTING 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from diskette. Check this file for errors by 
using the Show File <SF> or Print File (PF) command. 

5. Unload the diskette volume by using the Unload Volume 
(UV) command as follows: 

UV V-DCBLU 

6. Remove diskette DCBLU from the drive. 

7. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DC8LU. V=<dncsvolume>. DCBLU 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

8. Proceed to Section 3 to continue the installation. 



2. 3 DISK FORMAT 

When you receive the object on disk, perform the following steps: 

1. Load the DNCS/SNA Batch Emulator object disk DCBLU in 
an available drive and make it ready. Enable the disk 
write protection. 

2. Install the disk volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V=DCBLU 

where: 

<dsxx> is the name of the drive where the disk is 
loaded. 
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3. Copy the contents of disk DCBLU to the DNCS parts 
volume by using the Copy Directory (CD) command as 
follows: 

CD I=DCBLU. 0»<dncsvolume>. DCBLU* L=*. LISTING 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from disk. Check this file for errors by using 
the Show File (SF) or Print File <PF) command. 

4. Unload the disk volume by using the Unload Volume (UV) 
command as fallows: 

UV V-DCBLU 

9. Remove disk DCBLU from the drive. 

6. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DCBLU, V»<dncsvolume>. DCBLU 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

7. Proceed to Section 3 to continue the installation. 



2. 4 MAGNETIC TAPE FORMAT 

When you receive the object on magnetic tape, copy it to a disk 
as follows: 

1. Create the DNCS/SNA Batch Emulator object directory on 
the DNCS parts volume by using the Create Directory 
File (CFDIR) command as follows: 

CFDIR P=<dncsvolume>. DCBLU. M=50 

where: 

<dncsvolume> is the name of the DNCS parts volume. 
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2. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S-DCBLU* V=<dncsvolume>. DCBLU 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

3. Enable the magnetic tape write protection. Then mount 
the tape on an available tape drive and make it ready. 

4. Copy the contents of the tape to the DNCS/SNA Batch 
Emulator object directory by using the Restore 
Directory (RD) command as follows: 

RD S=<mtxx>» D-DCBLU. L». LISTING 

where: 

<mtxx> is the name of the drive where the tape is 
mounted. 

The file .LISTING contains a listing of the directory 
restored from magnetic tape. Check this file for 
errors by using the Show File (SF) or Print File (PF) 
command. 

5. Rewind and unload the tape. 

6. Proceed to Section 3 to continue the installation. 
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2. 9 ADD-ON FORMAT 

When you receive the object as an add-on. perform the steps in 
either paragraph 2.5.1. 2.3.2. or 2.9.3. depending on whether the 
add-on is received on the DNOS system disk, on a secondary disk 
with the DNCS nucleus, or on a secondary disk without the DNCS 
nucleus. 



2. 9. 1 DNOS System Disk Add-On 

If you receive the DNCS/SNA Batch Emulator object add-on on the 
DNOS system disk and the system is running under that disk, 
perform the following steps: 

1. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DCBLU. V» DCBLU 

2. Proceed to Section 3 to continue the installation. 



2.9.2 Secondary Disk Add-On with DNCS Nucleus 

If you receive the DNCS/SNA Batch Emulator object add-on on a 
secondary disk that includes the DNCS nucleus object, perform the 
following steps: 

1. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DCBLU. V~Cdncsvolume>. DCBLU 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

2. Proceed to Section 3 to continue the installation. 
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2.5.3 Secondary Disk Add-On Without DNCS Nucleus 

If you receive the DNCS/SNA Batch Emulator object add-on on a 
secondary disk that does not include the DNCS nucleus object, 
perform the following steps: 

1. Load the disk in an available drive and make it ready. 
Disable the disk write protection. 

2. Install the disk volume by using the Install Volume 
(IV) command as follows: 

IV U»<dsxx>. V»<addvolume> 

where: 

<dsxx> is the name of the drive where the disk 
is loaded. 

<addvolume> is the volume name of the add-on disk. 

3. Copy the DNCS/SNA Batch Emulator object to the DNCS 
parts volume by using the Copy Directory (CD) command 
as follows: 

CD I=<addvolume>. DCBLU. 0*»<dncsvolume>. DCBLU. 
L=. LISTING 

where: 

<addvolume> is the volume name of the add-on disk. 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from disk. Check this file for errors by using 
the Show File (SF) or Print File (PF) command. 

4. Unload the add-on disk volume by using the Unload 
Volume (UV) command as follows: 

UV V»<addvolume> 

where: 

<addvolume> is the volume name of the add-on disk. 
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9. Remove the add-on disk from the drive. 

6. Assign the synonym DCBLU to the DNCS/SNA Batch Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DCBLU, V«Kdncsvolume>. DCBLU 

where: 

<dncsvolume> is the name of the DNCS parts volume. 

7. Proceed to Section 3 to continue the installation. 
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Section 3 
Installing SBLU 



3. 1 GENERAL 

The procedures in this section describe how to install. patch* 
and execute the SBLU emulator. 



3. 2 INSTALLING SBLU 

Perforin the following steps to install the SBLU emulator: 

1. Verify that the SBLU product media synonym DCBLU exists 
as a result of media preparation explained in Section 
2. The value of this synonym is the pathname of the 
directory containing the SBLU emulator. 

2. Enter the following command to access the SBLU object 
installation SCI procedures: 

. USE DCBLU. RELEASE. PROC. . SSCMDS 

3. Install the SBLU emulator by using the Install SBLU 
(INSBLU) command as follows: 

C J INSBLU 



INSTALL DNCS SBLU EMULATOR 
DNCS SBLU DIRECTORY 
DNOS SYSTEM VOLUME 
DNCS COMMAND DIRECTORY 



DCBLU 



DNCS SBLU DIRECTORY 

Enter the directory pathname of the DNCS SBLU 
object directory. The proper response is DCBLU. 

DNOS SYSTEM VOLUME 

Enter the volume name of the DNOS system disk. 

DNCS COMMAND DIRECTORY 

Enter the directory pathname of the DNCS SCI 
command directory. 

The following messages appear after you enter INSBLU. 
Respond to each message by pressing the RETURN key. 
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BATCH LISTING FILE WILL BE. . . : 

'<dcblu>. BL. INSBLU' 

where: 

<dcblu> is the value entered for the DNCS SBLU 
DIRECTORY prompt (synonym expanded). 

4. Wait for INSBLU to complete by using the Wait for 
Background Task to Complete (WAIT) command as follows: 

C 3 WAIT 

5. When INSBLU completes, the following message appears: 

x ERRORS ON DNCS SBLU INSTALL STREAM 

If the number of errors reported is nonzero* examine 
the batch file listing <dcb I u>. BL. INSBLU to determine 
the cause of the error(s). Correct the error(s) and 
reenter INSBLU. 



3. 3 PATCHING SBLU 

Perform the following steps to patch SBLU: 

1. Patch the SBLU emulator by using the Patch SBLU 
(PATBLU) command as follows: 

C3PATBLU 



PATCH DNCS SBLU EMULATOR 
DNCS SBLU DIRECTORY 
DNOS SYSTEM VOLUME 
DNCS COMMAND DIRECTORY 



DCBLU 



DNCS SBLU DIRECTORY 

Enter the directory pathname of the DNCS SBLU 
object directory. The proper response is DCBLU. 

DNOS SYSTEM VOLUME 

Enter the volume name of the DNOS system disk. 

DNCS COMMAND DIRECTORY 

Enter the directory pathname of the DNCS SCI 
command directory. 

The following messages appear after you enter INSBLU. 
Respond to each message by pressing the RETURN key. 
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BATCH LISTING FILE WILL BE. . . : 

'<dcblu>. PATCH. LSTBLU' 

inhere: 

<dcblu> is the value entered for the DNCS SBLU 
DIRECTORY prompt (synonym expanded). 

2. Wait for PATBLU to complete by using the Wait for 
Background Task to Complete (WAIT) command as follows: 

C3WAIT 

3. When PATBLU completes, the following message appears: 

x ERRORS ON DNCS SBLU PATCH STREAM 

If the number of errors reported is nonzero/ examine 
the batch file listing <dcblu>. PATCH. LSTBLU to 
determine the cause of the error(s). Correct the 
error (s) and reenter PATBLU. 



3. 4 EXECUTING SBLU 

The SBLU job may be started via the Execute SBLU (XBLU) command 
and stopped via the Terminate SBLU (TBLU) command. For a more 
detailed discussion of the use of XBLU, TBLU, and other SBLU SCI 
commands, refer to the DIMOS DNCS/SNA Batch User's Guide , release 
1. 0. 0, part number 2239996-9701. 
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